home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / mail / xmailbox.4-b / xmailbox / xmailbox-2.4 / README < prev    next >
Text File  |  1996-07-01  |  3KB  |  80 lines
  1. README
  2. ======
  3.  
  4. The xmailbox program started out as an enhanced xbiff. However, the latest
  5. version includes support for sound effects and animation. The default
  6. functionality employs two images for the "mail in mailbox" and "no mail"
  7. states, in the form of XPM type 3 files. The default images are, respectively,
  8. that of an empty mailbox with its flag down, and that of an open mailbox,
  9. with its flag up and a letter visible inside. Animation can be enabled for
  10. playing up to 8 XPM files in repeated sequence.
  11.  
  12. The application can also, optionally, play a sound through a workstation's
  13. audio device, instead of generating the default beep sound, whenever new
  14. mail arrives. The following sound packages/drivers are supported:
  15.  
  16.     1) NCD audio server
  17.     2) Rplay sound package
  18.     3) Linux's Sun-compatible audio driver (/dev/audio)
  19.     4) Standard SUN audio driver (/dev/audio)
  20.     5) FreeBSD SUN-compatible audio driver (contributed by Brian Clapper - 
  21.        bmc@telebase.com)
  22.     6) Any external sound player (contributed by Laurent Martin -
  23.        martin@isia.cma.fr)
  24.  
  25. By default, pressing any mouse button in the image forces xmailbox to 
  26. remember the current size of the mail file as being the "empty" size and 
  27. to change its image accordingly. In addition to this, the user can 
  28. optionally have xmailbox invoke his/her favourite mail retrieving program.
  29.  
  30. This program is nothing more than a wrapper around the Mailbox widget
  31. included with the program's source distribution. Mailbox was derived by
  32. the Mailbox widget included with the Athena Widget Set. The first version
  33. of Mailbox was a hack based on the X11R5 Mailbox widget written by
  34. Jim Fulton, MIT X Consortium, and Ralph Swick, DEC/MIT Project Athena. The
  35. xmailbox source is very similar to xbiff.
  36.  
  37. INSTALLATION
  38. ============
  39.  
  40. If you are planning to use the NCD Audio server or the rplay sound package, 
  41. you can obtain these packages from ftp.x.org in /contrib/netaudio and 
  42. /contrib/rplay respectively.  These packages provide network sound support.
  43.  
  44. To build xmailbox:
  45.  1. make any required changes in Imakefile, by specifying where the
  46.     XPM includes and libs are, as well as the desired audio interface,
  47.  2. run "xmkmf -a" and then "make".
  48.  
  49. This program has been tested on Sun Sparc 2 & IPX under SunOS 4.1.3,
  50. HP 9000/710 under HP-UX 9.01, and a 486 DX2-66 PC equipped with a
  51. Soundblaster 16 under Linux 1.2.x, 1.3.x, and 2.0.
  52.  
  53. NOTE: You'll need xpm-3.4 or higher in order to compile xmailbox.
  54. ----  As of this writing, the latest version of xpm is 3.4; it can be
  55.       obtained from ftp.x.org (in directory contrib, file xpm-3.4.tar.gz).
  56.  
  57.  Enjoy!
  58.  
  59.  Dimitrios P. Bouras (dbouras@hol.gr) and
  60.  William K. W. Cheung (wcheung@mail.spiralcomm.com)
  61.  
  62. ACKNOWLEDGMENT
  63. ==============
  64.  
  65. The authors would like to thank the following individuals for contributing
  66. source codes to xmailbox:
  67.  
  68. Brian Clapper (bmc@telebase.com)
  69. Laurent Martin (martin@isia.cma.fr)
  70.  
  71. -------------------------------------------------------------------------------
  72. THE AUTHORS (Dimitrios P. Bouras and William K. W. Cheung) MAKE NO
  73. REPRESENTATIONS ABOUT THE SUITABILITY OF THIS SOFTWARE FOR ANY PURPOSE.
  74. IT IS PROVIDED "AS IS" WITHOUT ANY EXPRESS OR IMPLIED WARRANTY.
  75.  
  76. Xbiff IS COPYRIGHT 1988, X CONSORTIUM
  77. SEE X(1) FOR A FULL STATEMENT OF RIGHTS AND PERMISSIONS.
  78. -------------------------------------------------------------------------------
  79.  
  80.